home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / man / cat.1 / shar.1 < prev    next >
Text File  |  1995-07-25  |  12KB  |  331 lines
  1.  
  2.  
  3.  
  4.      SSSSHHHHAAAARRRR((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((AAAAuuuugggguuuusssstttt 11112222,,,, 1111999999990000))))          SSSSHHHHAAAARRRR((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           shar - create shell archives
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           shar [ options ] file ...
  13.           shar -S [ options ]
  14.  
  15.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.           Shar creates "shell archives" (or shar files) which are in
  17.           text format and can be mailed. These files may be unpacked
  18.           later by executing them with /bin/sh. The resulting archive
  19.           is sent to standard out unless the -_o option is given.  A
  20.           wide range of features provide extensive flexibility in
  21.           manufacturing shars and in specifying shar "smartness."
  22.           Archives may be "vanilla" or comprehensive.  This manual
  23.           page reflects shar version 3.49.
  24.  
  25.         OOOOPPPPTTTTIIIIOOOONNNNSSSS
  26.           Options can be given in any order. Some options depend on
  27.           each other:
  28.                The -_o option is required if the -_l or -_L option is used.
  29.                The -_n option is required if the -_a option is used.
  30.                See -_V below.
  31.  
  32.           -_V   Produce "vanilla" shars which rely only upon the
  33.                existence of sed and echo in the unsharing environment.
  34.                In addition, "if test" must also be supported if the -_X
  35.                option is used.  The -_V silently disables options
  36.                offensive to the "network cop" (or "brown shirt"), but
  37.                does warn you if it is specified with -_B, -_C, -_p or -_M
  38.                (any of which does or might require uudecode or
  39.                compress in the unsharing environment).
  40.  
  41.           -_v   Verbose OFF. Disables the inclusion of comments to be
  42.                output when the archive is unpacked.
  43.  
  44.           -_w   Do NOT check with 'wc -c' after unpack. The default is
  45.                to check.
  46.  
  47.           -_n name
  48.                Name of archive to be included in the header of the
  49.                shar files.  See the -_a switch.
  50.  
  51.           -_a   Allows automatic generation of headers:
  52.                     Submitted-by: who@where
  53.                     Archive-name: <name>/part##
  54.                The <name> must be given with the -_n switch.  If name
  55.                includes a '/' "/part" isn't used. Thus:
  56.                     -n xyzzy                      produces:
  57.                                                   xyzzy/part01
  58.                                                   xyzzy/part02
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                           (printed 3/9/94)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      SSSSHHHHAAAARRRR((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((AAAAuuuugggguuuusssstttt 11112222,,,, 1111999999990000))))          SSSSHHHHAAAARRRR((((1111))))
  71.  
  72.  
  73.  
  74.                     -n xyzzy/patch                produces:
  75.                                                   xyzzy/patch01
  76.                                                   xyzzy/patch02
  77.  
  78.                     -n xyzzy/patch01.             produces:
  79.                                                   xyzzy/patch01.01
  80.                                                   xyzzy/patch01.02
  81.  
  82.                The who@where can be explicitly stated with the -_s
  83.                switch if the default isn't apropriate.  Who@where is
  84.                essentially built as `whoami`@`uname`.
  85.  
  86.           -_s who@where
  87.                Override automatically determined submitter name.
  88.  
  89.           -_x   Overwrite existing files without checking.  If neither
  90.                -_x nor -_X is specified, the unpack will check for and
  91.                not overwrite existing files when unpacking the archive
  92.                (unless '-c' is passed as a parameter to the script
  93.                when unpacking).
  94.  
  95.           -_X   Interactively overwrite existing files (DO NOT USE FOR
  96.                SHARS SUBMITTED TO THE NET).
  97.  
  98.           -_B   Treat all files as binary, use uuencode prior to
  99.                packing. This increases the size of the archive. The
  100.                recipient must have uudecode in order to unpack.  (USE
  101.                OF UUENCODE IS NOT APPRECIATED BY MANY ON THE NET).
  102.  
  103.           -_T   Treat all files as text (default).
  104.  
  105.           -_C   Compress and uuencode all files prior to packing. The
  106.                recipient must have uudecode and uncompress in order to
  107.                unpack (USE OF UUENCODE AND COMPRESS IS NOT APPRECIATED
  108.                BY MANY ON THE NET).
  109.  
  110.           -_m   Generate 'touch' commands to restore the file
  111.                modification dates when unpacking files from the
  112.                archive.
  113.  
  114.           -_p   Allow positional parameter options. The options "-_B"
  115.                and "-_T" and "-_C" may be embedded, and files to the
  116.                right of the option will be processed in the specified
  117.                mode.
  118.  
  119.           -_b X When doing compression, use '-bX' as a parameter to
  120.                compress.  The -_B options turns on the -_C option by
  121.                default.
  122.  
  123.           -_M   Mixed mode. Determine if the files are text or binary
  124.                and archive correctly.  Files found to be binary are
  125.                uudecoded prior to packing (USE OF UUENCODE IS NOT
  126.  
  127.  
  128.  
  129.      Page 2                                           (printed 3/9/94)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      SSSSHHHHAAAARRRR((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((AAAAuuuugggguuuusssstttt 11112222,,,, 1111999999990000))))          SSSSHHHHAAAARRRR((((1111))))
  137.  
  138.  
  139.  
  140.                APPRECIATED BY MANY ON THE NET).
  141.  
  142.           -_P   Use temporary files instead of pipes in the shar file.
  143.  
  144.           -_c   Start the shar with a cut line. A line saying 'Cut
  145.                here' is placed at the start of each output file.
  146.  
  147.           -_f   Restore by filename only, rather than path. This option
  148.                causes only file names to be used, which is useful when
  149.                building a shar from several directories, or another
  150.                directory.  Note that if a directory name is passed to
  151.                shar, the substructure of that directory will be
  152.                restored whether -_f is specified or not.
  153.  
  154.           -_d XXX
  155.                Use XXX to delimit the files in the shar instead of
  156.                SHAR_EOF.  This is for those who want to personalize
  157.                their shar files.
  158.  
  159.           -_F   Forces the prefix character (normally 'X' unless the
  160.                parameter to the -_d option starts with 'X') to be
  161.                prepended to every line even if not required.  This
  162.                option may slightly increase the size of the archive,
  163.                especially if -_B or -_C is used.
  164.  
  165.           -_o XXX
  166.                Save the archive to files XXX.01 thru XXX.nn instead of
  167.                standard out.  Must be used when the -_l or the -_L
  168.                switches are used
  169.  
  170.           -_l XX
  171.                Limit the output file size to XXk bytes but don't split
  172.                input files.
  173.  
  174.           -_L XX
  175.                Limit output file size to XXk bytes and split files if
  176.                necessary. The archives created with this option must
  177.                be unpacked in correct order.
  178.  
  179.           -_S   Read list of files to be packed from the standard input
  180.                rather than from the command line.  Input must be in a
  181.                form similar to that generated by the find command, one
  182.                filename per line.  This switch is especially useful
  183.                when the command line will not hold the list of files
  184.                to be packed. For example:
  185.  
  186.                find . -type f -print | sort | shar -S -C -L50 -o /tmp/big
  187.  
  188.                If -_p is specified on the command line, then the
  189.                options "-_B" and "-_T" and "-_C" may be included in the
  190.                standard input (on a line separate from filenames).
  191.                The maximum number of lines of standard input, file
  192.  
  193.  
  194.  
  195.      Page 3                                           (printed 3/9/94)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      SSSSHHHHAAAARRRR((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((AAAAuuuugggguuuusssstttt 11112222,,,, 1111999999990000))))          SSSSHHHHAAAARRRR((((1111))))
  203.  
  204.  
  205.  
  206.                names and options, may not exceed 1024.
  207.  
  208.      EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  209.           shar *.c > cprog.shar                # all C prog sources
  210.           shar -v *.[ch] > cprog.shar          # non-verbose, .c and .h files
  211.           shar -B -l28 -oarc.sh *.arc          # all binary .arc files, into
  212.                                                # files arc.sh.01 thru arc.sh.NN
  213.           shar -f /lcl/src/u*.c > u.sh         # use only the filenames
  214.  
  215.      WWWWAAAARRRRNNNNIIIINNNNGGGGSSSS
  216.           No chmod or touch is ever generated for directories created
  217.           when unpacking.  Thus, if a directory is given to shar, the
  218.           protection and modification dates of corresponding unpacked
  219.           directory may not match those of the original.
  220.  
  221.           If a directory is passed to shar, it may be scanned more
  222.           than once.  Therefore, one should be careful not change the
  223.           directory while shar is running.
  224.  
  225.           Be careful that the output file(s) are not included in the
  226.           inputs or shar may loop until the disk fills up.  Be
  227.           particularly careful when a directory is passed to shar that
  228.           the output files are not in that directory (or a
  229.           subdirectory of that directory).
  230.  
  231.           Use of the -_B, -_M or -_C may slow the archive process
  232.           considerably, depending on the number of files.
  233.  
  234.           Use of -_X produces shars which _W_I_L_L cause problems with many
  235.           unshar procedures.  Use this feature only for archives to be
  236.           passed among agreeable parties.  Certainly, -_X is NOT for
  237.           shell archives which are to be submitted to Usenet.  Usage
  238.           of -_B or -_C in net shars will cause you to be flamed off the
  239.           earth.  Using -_m or not using -_F may also get you occasional
  240.           complaints.
  241.  
  242.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  243.           unshar(1)
  244.  
  245.      DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  246.           Error messages for illegal or incompatible options, for
  247.           non-regular, missing or inaccessible files or for (unlikely)
  248.           memory allocation failure.
  249.  
  250.      AAAAUUUUTTTTHHHHOOOORRRRSSSS
  251.           shar3 is a derived work based on the efforts of:
  252.           decvax!microsof!uw-beave!jim (James Gosling at CMU)
  253.           Michael A. Thompson, Dalhousie University, Halifax, N.S., Canada
  254.           davidsen@sixhub (Bill Davidsen)
  255.           rhg@CPS.COM (Richard H. Gumpertz)
  256.           colas@avahi.inria.fr (Colas Nahaboo)
  257.           bill@netagw.com (Bill Aten)
  258.  
  259.  
  260.  
  261.      Page 4                                           (printed 3/9/94)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      SSSSHHHHAAAARRRR((((1111))))          UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((AAAAuuuugggguuuusssstttt 11112222,,,, 1111999999990000))))          SSSSHHHHAAAARRRR((((1111))))
  269.  
  270.  
  271.  
  272.           dennis%nanovx@gatech.edu (Dennis Boylan)
  273.           wht%n4hgf@gatech.edu (Warren Tucker)
  274.           (other anonymous persons)
  275.  
  276.           man pages:
  277.           jhd@irfu.se (Jan Dj{rv)
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.      Page 5                                           (printed 3/9/94)
  328.  
  329.  
  330.  
  331.